home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_glimpse.idb / usr / freeware / catman / u_man / cat1 / glimpseserver.Z / glimpseserver
Text File  |  1997-09-09  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      GGGGLLLLIIIIMMMMPPPPSSSSEEEESSSSEEEERRRRVVVVEEEERRRR((((llll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 11111111,,,,    1111999999995555)))) GGGGLLLLIIIIMMMMPPPPSSSSEEEESSSSEEEERRRRVVVVEEEERRRR((((llll))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _g_l_i_m_p_s_e_s_e_r_v_e_r    - a server version of the glimpse searching
  10.       package.
  11.  
  12.      OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
  13.       _G_l_i_m_p_s_e is an    indexing and query system that allows you to
  14.       search through all your files    very quickly.  The use of
  15.       glimpse in servers that handle frequent queries is growing,
  16.       which    is why we wrote    glimpseserver to make searches more
  17.       efficient.  Glimpseserver starts a process that listens to
  18.       queries, runs    glimpse, and sends the answers back.  The main
  19.       advantage is that the    index is read only once    into memory
  20.       saving a lot of IO.  Glimpse communicates with glimpseserver
  21.       through a given port number.    See the    warning    about security
  22.       below.
  23.  
  24.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  25.       gggglllliiiimmmmppppsssseeeesssseeeerrrrvvvveeeerrrr    [ ----HHHH _d_i_r ----KKKK _p_o_r_t ----JJJJ _h_o_s_t....  ]]]]
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.       ----HHHH _d_i_r
  29.            specifies the directory of the index.  Similar to the
  30.            -H option of glimpse.  The default directory is the
  31.            home directory (~).
  32.  
  33.       ----KKKK _p_o_r_t
  34.            this is the TCP port for    communication: glimpseserver
  35.            waits for requests on this port and clients that    want
  36.            to search using the index in specified by the -H    option
  37.            must use    this port (by calling glimpse -K).  The
  38.            defaults    port number is 2001.
  39.  
  40.       ----JJJJ _h_o_s_t
  41.            the name    of the host.  The default is the host where
  42.            glimpseserver is    running, which is probably the only
  43.            possibility anyway.
  44.  
  45.      RRRREEEESSSSTTTTAAAARRRRTTTTIIIINNNNGGGG
  46.       If a new index is created by running glimpseindex every
  47.       night, restarting a new glimpseserver    is now easier:    simply
  48.       send a SIGUSR2 (signal #31 - i.e., "kill -31 pid") to
  49.       glimpseserver; it then re-reads the NEW index    and is ready
  50.       to serve requests again. (A SIGHUP, i.e., signal #1, can
  51.       also be sent instead of SIGUSR2 to make the glimpseserver
  52.       re-read the new index.)  The recommended way to do a fresh
  53.       indexing while the server is still running is:
  54.       send SIGSTOP to glimpseserver
  55.       do the indexing
  56.       send SIGUSR2 to glimpseserver
  57.       send SIGCONT to glimpseserver    (to ask    it to continue after
  58.       stop)
  59.       The SIGSTOP is required so that glimpseserver    doesn't    answer
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 11/3/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGLLLLIIIIMMMMPPPPSSSSEEEESSSSEEEERRRRVVVVEEEERRRR((((llll))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 11111111,,,,    1111999999995555)))) GGGGLLLLIIIIMMMMPPPPSSSSEEEESSSSEEEERRRRVVVVEEEERRRR((((llll))))
  71.  
  72.  
  73.  
  74.       any queries while the    indexing is going on.
  75.  
  76.      WWWWAAAARRRRNNNNIIIINNNNGGGG
  77.       Glimpseserver    should be used only for    public servers.     Any
  78.       client that knows the    port number can    get any    information
  79.       available in the index (and port numbers are not that
  80.       secret).  When glimpse is run    as a standalone    application it
  81.       requires read    permission of the index    and all    the files.
  82.       When glimpse uses the    -C option to communicate with
  83.       glimpseserver, glimpse (the client) does not require any
  84.       permission, because glimpseserver does all the searching.
  85.       So, we recommend not to run glimpseserver on any data    that
  86.       should be protected.    Glimpseserver is meant to be used for
  87.       public data.
  88.  
  89.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.       gggglllliiiimmmmppppsssseeee(1), gggglllliiiimmmmppppsssseeeeiiiinnnnddddeeeexxxx(1),
  91.  
  92.      BBBBUUUUGGGGSSSS
  93.       Please send bug reports or comments to
  94.       glimpse@cs.arizona.edu.
  95.  
  96.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  97.       Udi Manber and Burra Gopal, Department of Computer Science,
  98.       University of    Arizona, and Sun Wu, the National Chung-Cheng
  99.       University, Taiwan. (Email:  glimpse@cs.arizona.edu)
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 11/3/95)
  130.  
  131.  
  132.  
  133.